NEXOWARE c-entron ERP MCP-Server – Installation und Einrichtung

(Stand: 07/2026)

Verfügbar in Subscription: Ultimate · Nicht enthalten in Core · Pro – Kostenpflichtige Extension (zubuchbar)

Verfügbar ab Release: 2.0.2605.2194

Betrifft:

⚙️ Administration

Diese Anleitung beschreibt, wie du den NEXOWARE c-entron ERP MCP-Server als Docker-Container auf deinem WebService-Server installierst, konfigurierst und aktualisierst.

Voraussetzungen

Damit du den NEXOWARE c-entron ERP MCP-Server betreiben kannst, müssen folgende Punkte erfüllt sein:

Lizenz: Ultimate-Paket oder einzeln zugebuchtes Add-on.
WebService: c-entron WebService mindestens in Version 2.0.2605.2194.
Docker: Lauffähige Docker-Umgebung auf dem WebService-Server. Installationsanleitung und Systemanforderungen findest du unter docs.docker.com/engine/install.
Externe Erreichbarkeit: Die frei definierbare MCP-Server-URL (z. B. https://mcp.EIGENEDOMAIN.de) ist von außen erreichbar. Dafür sind eingerichtet:
- DNS-Eintrag
- Portfreigabe 443
- Reverse Proxy, der eingehende HTTPS-Anfragen intern an Port 5250 (Docker-Port) weiterleitet
KI-Anbieter: Aktives Business-Abonnement bei einem MCP-fähigen KI-Anbieter (wir empfehlen Anthropic/Claude).

Schritt 1 – Verzeichnisstruktur anlegen

Lege auf dem Server ein Verzeichnis für den Container an. Darin befinden sich die Datei docker-compose.yml und der Unterordner state.

Beispielstruktur: C:\Docker\c-entron-mcp-http\

Schritt 2 – docker-compose.yml anlegen

Lege im Verzeichnis die Datei docker-compose.yml mit folgendem Inhalt an. Die mit # <-- anpassen markierten Stellen passt du im nächsten Schritt an deine Umgebung an.

services:
  centron-mcp-server:
    image: ghcr.io/nexoware-systems/c-entron-mcp-server:latest
    pull_policy: always
    container_name: centron-mcp-server-http
    restart: unless-stopped
    ports:
      - "5250:5250"  # <-- anpassen, falls Port 5250 bereits belegt ist
    environment:
      CENTRON_MCP_SERVER_MODE: "remote"
      CENTRON_MCP_HTTP_URLS: "http://0.0.0.0:5250"
      ASPNETCORE_URLS: "http://+:5250"
      ASPNETCORE_ENVIRONMENT: "Production"
      CENTRON_API_BASE_URL: "http://host.docker.internal:1234/CentronService"  # <-- anpassen: URL des c-entron WebService
      CENTRON_API_TIMEOUT_SECONDS: "30"
      CENTRON_API_USE_JWT_LOGIN: "true"
      CENTRON_MCP_TOOL_MODE: "User"  # <-- "User" = nur lesend, "Agent" = auch schreibend
      # CENTRON_MCP_EXCLUDED_TOOLS: ""  # <-- optional: auszuschließende Tool-Bereiche
      CENTRON_LOCAL_OAUTH_ENABLED: "true"
      CENTRON_LOCAL_OAUTH_ISSUER: "http://localhost:5250"
      CENTRON_LOCAL_OAUTH_RESOURCE: "http://localhost:5250"
      CENTRON_LOCAL_OAUTH_SIGNING_KEY: "change-this-to-a-long-random-secret-min-32-chars"  # <-- anpassen: eindeutiger Schlüssel
      CENTRON_LOCAL_OAUTH_ACCESS_TOKEN_LIFETIME_MINUTES: "480"
      CENTRON_LOCAL_OAUTH_AUTHORIZATION_CODE_LIFETIME_MINUTES: "5"
      CENTRON_UPSTREAM_ENABLED: "false"  # <-- "true", wenn Microsoft Entra Login genutzt wird
      # CENTRON_UPSTREAM_TENANT_ID: "<tenant-guid>"
      # CENTRON_UPSTREAM_CLIENT_ID: "<azure-app-client-id>"
      # CENTRON_UPSTREAM_CLIENT_SECRET: "<azure-client-secret>"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - "C:/Docker/c-entron-mcp-http/state:/app/state"  # <-- anpassen: frei wählbarer lokaler Pfad

Schritt 3 – Konfiguration anpassen

Einstellung	Was ist zu tun?
`ports`	Prüfe, ob Port 5250 auf dem Server noch frei ist. Falls nicht, vergib einen anderen Port und passe den Reverse Proxy entsprechend an.
`CENTRON_API_BASE_URL`	Trage die URL deines c-entron WebService ein.
`CENTRON_MCP_TOOL_MODE`	Belasse den Wert auf `User` (nur lesend) oder stelle auf `Agent` um (auch schreibend).
`CENTRON_MCP_EXCLUDED_TOOLS`	Optional: Trage Tool-Bereiche ein, die nicht ausgeführt werden sollen, und entferne das `#` am Zeilenanfang (siehe Tabelle unten).
`CENTRON_LOCAL_OAUTH_SIGNING_KEY`	Pflicht: Hinterlege einen eindeutigen, zufälligen Schlüssel mit mindestens 32 Zeichen (z. B. eine generierte GUID).
`CENTRON_LOCAL_OAUTH_ACCESS_TOKEN_LIFETIME_MINUTES`	Lebensdauer des Tokens in Minuten. In der Vorlage sind 480 Minuten (8 Stunden) hinterlegt.
`CENTRON_UPSTREAM_ENABLED` und `CENTRON_UPSTREAM_*`	Nur bei Microsoft Entra Login: Setze den Wert auf `true`, entferne das `#` vor den drei Variablen und trage Tenant-ID, Client-ID und Client-Secret ein (siehe Schritt 5).
`volumes`	Trage den lokalen Pfad zu deinem `state`-Ordner ein.

Wichtig Verwende für CENTRON_LOCAL_OAUTH_SIGNING_KEY niemals den Platzhalterwert aus der Vorlage. Der Schlüssel sichert die Anmeldung am NEXOWARE c-entron ERP MCP-Server ab.

Tool-Bereiche für CENTRON_MCP_EXCLUDED_TOOLS

Bereich	Enthaltene Funktionen
`Helpdesk`	Funktionen rund um den Helpdesk
`CRM`	Funktionen rund um CRM (Aktivitäten usw.)
`Receipts`	Funktionen rund um das Belegwesen
`Statistics`	Funktionen rund um Statistiken
`Accounts`	Grundfunktionen rund um den Adressstamm
`AccountsExtended`	Erweiterte Funktionen rund um den Adressstamm (Konditionen, Finanzen, Bankverbindungen usw.)

Setzt du beispielsweise kein ServiceBoard ein, ist es sinnvoll, den Bereich Helpdesk auszuschließen.

Schritt 4 – Container starten

Öffne ein Terminal, wechsle in das Verzeichnis, in dem die docker-compose.yml liegt, und führe folgenden Befehl aus:

docker compose up -d

Ist alles korrekt konfiguriert, ist der Container anschließend online.

Wenn sich Benutzer über Microsoft Entra anmelden sollen:

Trage in deiner Entra-App-Registrierung unter Web folgende Umleitungs-URI ein: https://<deine-mcp-server-url>/signin-oidc (Beispiel: https://mcp.EIGENEDOMAIN.de/signin-oidc)
Setze in der docker-compose.yml CENTRON_UPSTREAM_ENABLED auf "true".
Entferne das # vor CENTRON_UPSTREAM_TENANT_ID, CENTRON_UPSTREAM_CLIENT_ID und CENTRON_UPSTREAM_CLIENT_SECRET und trage die Werte aus deiner App-Registrierung ein.
Starte den Container mit docker compose up -d neu.

Updates einspielen

Steht eine neue Version des Images bereit, öffne ein Terminal im Verzeichnis der docker-compose.yml und führe folgende Befehle aus:

docker compose pull
docker compose up -d

Datenschutz

Der NEXOWARE c-entron ERP MCP-Server läuft auf deinem eigenen Server und leitet dort die Anfragen weiter. Für die eigentliche Verarbeitung der Anfragen benötigst du zusätzlich ein KI-Tool deines Vertrauens – etwa ChatGPT, Copilot oder Claude.

AVV erforderlich Du bist dafür verantwortlich, mit dem gewählten KI-Anbieter einen AVV (Auftragsverarbeitungsvertrag) abzuschließen, damit die Daten DSGVO-konform verarbeitet werden.

Empfehlung Optimal ist der Einsatz des NEXOWARE c-entron ERP MCP-Servers mit der NEXOWARE AI Agent Platform. So kannst du das NEXOWARE LLM nutzen.

Checkliste (Kurzfassung)

Ultimate-Paket oder Add-on vorhanden, WebService mindestens Version 2.0.2605.2194, Docker auf dem WebService-Server lauffähig.
MCP-Server-URL extern erreichbar (DNS, Port 443, Reverse Proxy auf Port 5250).
Verzeichnis mit state-Ordner angelegt.
docker-compose.yml angelegt: Port, WebService-URL, Tool-Modus, ausgeschlossene Tools, Signing Key, Token-Lebensdauer und Volume-Pfad angepasst.
Optional: Entra-Login konfiguriert und Umleitungs-URI /signin-oidc eingetragen.
docker compose up -d ausgeführt, Container online.
AVV mit dem KI-Anbieter abgeschlossen.

Voraussetzungen​

Schritt 1 – Verzeichnisstruktur anlegen​

Schritt 2 – docker-compose.yml anlegen​

Schritt 3 – Konfiguration anpassen​

Tool-Bereiche für CENTRON_MCP_EXCLUDED_TOOLS​

Schritt 4 – Container starten​

Schritt 5 – Microsoft Entra Login einrichten (optional)​

Updates einspielen​

Datenschutz​

Checkliste (Kurzfassung)​

Verwandte Themen​